#Claude Code 正确的安装方式

#安装方式

curl -fsSL https://claude.ai/install.sh | bash

#为什么要装 CC-Switch

CC-Switch 是一款 Claude Code 辅助工具，提供版本切换、配置管理等功能。

直接订阅的结果：

flowchart LR
    A[中国大陆用户] --> B[订阅 Claude Code]
    B --> C[账号封禁]
    C --> D[无法使用]

通过中转站的方案：

flowchart LR
    A[中国大陆用户] --> B[API 中转服务]
    B --> C[Claude Code]
    C --> D[正常使用]

我们需要配置多个专业中转供应商，并且不定期切换，以保证稳定使用 Claude Code。官方的配置参数都是通过环境变量传入的，手动配置非常麻烦，CC-Switch 可以大大简化这个过程。

#主要功能

• 供应商管理：一键切换 API 配置
• MCP 服务器管理：统一管理 MCP 配置
• Skills 管理：从 GitHub 自动发现和安装 Skills
• Prompts 管理：多预设系统提示词快速切换
• 配置同步：支持配置导入导出和云同步

#安装 CC-Switch

从 GitHub Releases 下载对应安装包：https://github.com/farion1231/cc-switch/releases

macOS 也可以通过 Homebrew 安装：

brew tap farion1231/ccswitch
brew install --cask cc-switch

Windows 用户直接下载 MSI 安装包：https://github.com/farion1231/cc-switch/releases/download/v3.10.3/CC-Switch-v3.10.3-Windows.msi

#使用方法

切换供应商：点击「添加供应商」选择预设或自定义配置，在主界面选择后点击「启用」即可。

#快速体验

如果你当前没有可用的中转供应商，可以使用我们提供的测试参数快速体验 Claude Code。

以下测试参数仅供体验使用，额度有限，请勿大量占用，测完即止，感谢配合。

测试参数：

• API Key：sk-mGsYKzIiwgt9ZSqTMA3G8eMp0ZnKJ7QINvQWIxM2wRKYZysV
• API 地址：https://free.duckcoding.com

配置步骤：

1. 在 CC-Switch 中点击「添加供应商」
2. 选择「自定义」，填入上方的 API Key 和 API 地址
3. 返回主界面，选择该供应商并点击「启用」

#Claude Code 基础配置

安装完成后，建议配置以下环境变量来优化使用体验。

#关闭自动更新

Claude Code 默认启用自动更新，建议手动控制版本更新节奏，避免新版本引入的不稳定问题。同时可以关闭非必要的遥测数据收集。

在配置文件中添加以下环境变量：

{
  "language": "Simplified Chinese",
  "permissions": {
    "defaultMode": "plan"
  },
  "env": {
    "DISABLE_AUTOUPDATER": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "ENABLE_LSP_TOOL": "1",
    "MAX_THINKING_TOKENS": "31999"
  }
}